複数 IPLware アプリケーションの統合

IPLWuni 1.40

Copyright(C) 2019-24 まりも (DOSsoft)

■１．IPLWuniとは？

　IPLware というIPL組み込み型のアプリケーションがあり、最大８個までのアプリケーションを組み込むことができます。しかし８個でも足らないという需要があるため作られたのが、本ツール IPLWuniです。　IPLWuniでは、複数のIPLware アプリケーションを一つにまとめるということを行います。これによりIPLwareのディレクトリ数の上限を緩和することができるでしょう。IPLWuni内部には16個ぶんのディレクトリがあり、最大16個までのIPLwareアプリケーションをまとめることができます。IPLWuniで統合したものは、IPLwareからは IPLWAPPS.BIN という１個のアプリケーションとみなされます。

■２．使い方

　まずアーカイブを解凍して、カレントディレクトリにそのすべてのファイルがある状態にします。UNILDR.DAT というファイルがカレントディレクトリに存在すれば、それをローダプログラムとします。なければ標準で内蔵しているローダプログラムが使用されます。

　次に、組み込みたいIPLwareアプリケーションのファイルをカレントディレクトリに用意してください。

　たとえばそれらが iplapp1.bin iplapp2.com iplapp3.dat　であるとする場合、コマンドラインから

　 IPLWuni iplapp1.bin iplapp2.com iplapp3.dat

　のように打ちます。つまりまとめたいファイルの名前をコマンド引数に与えます。

　ファイルがカレントディレクトリにない場合は、full path 名を与えてください。拡張子がある場合それを省略できません。拡張子を除いた部分のファイル名が同一のものでも統合はできます。なおコマンド引数の仕様で127文字以内しか記述できませんので、ファイルが多数となる場合には注意して下さい。

（バージョン1.10から）

　それぞれのアプリケーションの実行後に画面を１秒程度表示し続けるかどうかの可否を問われますので、ＹまたはＮで答えて下さい。Ｎのときはほとんど表示せずに次のアプリケーションに実行が移りますが、その際SHIFTキーを押し続けていれば、その間表示は保持されます。ただしアプリケーション側でもともと表示時間を確保している場合は、Ｙで応答しないほうがよいでしょう。表示時間がさらに長くなってしまいます。

　実行が正常に終了すると、IPLWAPPS.BINというファイルが作られますので、それを iplware IPLWAPPS.BIN

　で一括してIPLに組み込みます。

■３．動作結果

　再起動し、IPLwareとして実行が開始されると、画面下の方(20行目)に

　　　　　　　　　　IPLWAPPS　ロードします iplapp1

のように表示されます。「ロードします」の後の文字列は、統合前の各アプリケーションの名前となり、変化します。シフトキーを押下し続けていると、次のアプリケーションの実行に移る前に画面表示を保持します。実行順序はコマンドラインに書いたモジュールの記述順に対応しています。実行の前後関係が重要なアプリケーションがあれば、それを記述順序に反映させてください。

■４．注意事項

・ロードされるセグメント

　IPLWuniにまとめた場合、7000:0100hにロードされて実行されます。本来のIPLwareでは6000:0100h にロードされますので、ロードアドレスに極度に依存したようなアプリケーションは統合できません。

・個別に実行制御できない

　IPLWuni内のもとのアプリケーションを個別に実行可能／不可の設定することはできません。本来のIPLwareでは HELPキーでそれができ、DELキーで実行回避ができましたが、これらの操作ではIPLWAPPS.BIN 全体の制御となります。

　したがって、じゅうぶんにデバッグがなされているアプリケーションのみを統合するようにしてください。ひとつのアプリケーションがハングアップするような場合でも、IPLWAPPS.BINの作り直し、組み込み直しとなります。

・バージョン値は3.00

　IPLWuni内で実行されるアプリケーションでは、実行開始時点のレジスタは不定であり、唯一SI レジスタが 0300hということのみを保証します。これはIPLware バージョン 3.00のときの仕様と同じです。そのほか保証外ですが DXとCXとDI はいずれもFFFFhとしています。

・ディスクに設定を書き込むアプリケーションは統合不可

　IPLware 3.33以上では、ディスクに設定を書き込むアプリケーションを実行できましたが、IPLWuni 内からロードされた場合は実行開始時点のレジスタがアプリケーションのディスク上の存在位置を示さないことから、そのようなアプリケーションを実行しても、正しく書き込みができません。そのような既存アプリケーションとしては "PCISET"があります。

　なお、ディスク番地を示すレジスタ初期値の DX:CXは FFFFFFFFh を指しているので、正しくバージョンチェックを行っていないディスク書き込みIPLwareがあったとしても、単純に書き込みに失敗するだけで、既存のデータ域を潰すということはないと考えられます。

・多重（入れ子）の統合は不可

　統合したファイルを、また統合するということは、ファイル作成上はできますが、その実行は不可能です。ローダとして残る実行域のセグメントが重複するためです。

■５．その他

・IPLwareタイプ判別

　ファイル名の拡張子が .COM の場合はIPLwareタイプ２として扱い、IPLWuni内部でも戻りコードをそれに対応したものとして扱います。判断基準は拡張子だけであり、 .COM以外であれば RETF命令で戻るタイプ１として扱われます。拡張子がない場合も同じです。

・統合アプリケーション名は任意

　IPLWuniでは固定の名前 IPLWAPPS.BINを出力しますが、これをリネームしてしまえば、別のアプリケーションということになり、統合されたものを複数起動することができます。実質的に非常に多数のIPLwareを組み込むことができるわけです。

・ソースファイルについて

　核になるローダ部分について、アセンブリ言語のソースファイルを添付します。ファイル名は UNILDR.S です。

　UNILDR.DATはこのソースをアセンブルして得られる最小単位の統合アプリのテンプレートでもあります。このファイルはIPLWAPPS.BIN 作成時に存在すれば読み込まれます（なくても構いません）。このファイルを使う場合は、不用意に改変や破壊をしないようにご注意ください。

・バージョン1.30から

　UNILDR.DATの存在は必須でなくなりました。ユーザがオリジナルのローダプログラムを作成して使うことを想定し、別ファイルとしていましたが、とくに開発もしない一般のユーザにはかえって不便でしたので、標準で内蔵するローダプログラムを使用することとしました。

■６．技術的なこと

　IPLWAPPS.BINおよびそのテンプレートとなるUNILDR.DATのファイル構造について説明します。いずれも先頭の１６バイトはジャンプ命令およびシグネチャ文字列です。 0010hバイト目から0110hバイト目までの16×16バイトがディレクトリです。１つの要素は16バイトで、次のような構造となっています。これはIPLware本体のディレクトリと同様です。

「ディレクトリ」のバイトオフセットの内容

0～7

IDname プログラムを登録したときの識別名 8文字（以内）。

用途廃止しているが、将来使用する可能性もある。

実行制御ビット

ビット７	用途廃止
ビット６	プログラムモジュールタイプ２であることの識別。タイプ２（RET命令で終了するCOMファイル形式プログラム）のときは１、従来からのモジュールタイプの場合は０。
ビット４	表示時間延長 1=有 0=無

10～11

プログラムモジュールのバイト数。すなわちもとのファイルのバイト数。

12～15

ユーザプログラムモジュールが格納されているオフセット位置

（例）　　　　　　　　バ イ ト 並　び　
　00　01　02　03　04　05　06　07　08　09　10　11　12　13　14　15　
　'I' 'P' 'L' 'A' 'P' 'P' '0' '1' xx　ww　(yyyy)　(  zzzzzzzz  )　
(説明)
"IPLAPP01"　:プログラムIDname(一例)　
xx　　　　　:（使用していない）
ww　　　　　:実行制御ビット、タイプを示す、00hまたは40h  +10hのときは表示延長
yyyy　　　　:プログラムモジュールのバイト数　
zzzzzzzz　　:プログラムモジュールの格納位置で先頭からのオフセット

ただし12～15バイト目はアプリケーションが存在するディスク番地に代わって、統合ファイルの先頭からの存在バイト位置を示しています。ダブルワード長ありますが実際にはショートワードぶんしか使いません。統合ファイル内ではチェックサムは検査されません。制御ビットはIPLware本体のものと同じ定義としてあり、bit6が元のアプリケーションのタイプです。COMファイル型の場合に1となりそれ以外は0となります。bit 4を表示待ち時間の有無のbitとして今回新たに定義しました。

■７．お約束

[同意の上ダウンロードする]

【改版履歴】

　年月日　　　版数　内容
2019. 6. 3　　1.00　新規作成
2019. 6. 4　　1.10　Type2が実行できなかった問題の修正、表示保持機能を追加
2022. 5.23　　1.20　16bit CPU機でもLoader部が動作するようにした
2022.10.10　　1.30　UNILDR.DATがなくても実行できるように仕様を変更
2024. 3.20　　1.40　IPLwareアプリケーションファイル名をPATH名で指定可能となった

複数 IPLware アプリケーションの統合

IPLWuni 1.40

Copyright(C) 2019-24 まりも (DOSsoft)